Приложение 4

Теги CFML

Чтобы облегчить поиск и восприятие информации, данное приложение разделено на две части: в первой части теги сгруппированы в алфавитном порядке (без учета первых двух символов CF) с указанием условного кода, по которому можно найти описание того или иного тега во второй части данного приложения, где они сгруппированы в порядке принадлежности к той или иной категории с кратким описанием синтаксиса.

Условный код представляет собой два числа, разделенных точкой, где первое число указывает на номер раздела принадлежности тега, а второе число представляет собой порядковый номер тега внутри раздела.

Например, тег <CFABORT>, имеющий код 7.1, предполагает, что описание данного тега следует искать в седьмом разделе, а сам тег описан первым по порядку.

Алфавитный порядок

А


<CFABORT>

7.1

<CFASSOCIATE> 10.2

<CFAPPLET>

1.1

<CFAUTHENTICATE> 10.З

<CFAPPLICATION>

10.1


В


<CFBREAK>

7.2

С


<CFCACHE>

11.1

<CFCONTENT> 4.2

<CFCOL>

4.1

<CFCOOKIE,> 9.1

<CFCOLLECTION>

6.1


D


<CFDIRECTORY>

3.1

<CFDUMP> 9.2

E


<CFERROR> <CFEXECUTE>

5.1 6.2

<CFEXIT> 7.3

F


<CFFILE> <CFFLUSH>

3.2 11.2

<CFFORM> 1.2 <CFFTP> 8.1

G

.

<CFGRAPH> <CFGRAPHDATA> <CFGRID>

6.3 6.4 1.3

<CFGRIDCOLUMN> 1.4 <CFGRIDROW> 1.5 <CFGRIDUPDATE> 1.6

H


<CFHEADER> <CFHTMLHEAD>

I

11.3

11.4

<CFHTTP> 8.2 <CFHTTPPARAM> 8.3

<CFIF>/<CFELSEIF>/<CFELSE> <CFIMPERSONATE> <CFINCLUDE>

7.4 10.4 11.5

<CFINDEX> 6.5 <CFINPUT> 1.7 <CFINSERT> 2.1

L


<CFLDAP> <CFLOCATION> <CFLOCK>

8.4 7.5 10.5

<CFLOG> 4.3 <CFLOOP> 7.6

M


<CFMAIL> <CFMAILPARAM>

8.5 8.6

<CFMODULE> 10.6

O



<CFOBJECT>

6.6

<CFOUTPUT>

4.4

Р



<CFPARAM>

9.3

<CFPROCPARAM>

2.2

<CFPOP>

8.7

<CFPROCRESULT>

2.3

<CFPROCESSINGDIRECTIVE>

4.5



Q



<CFQUERY>

2.4

<CFQUERYPARAM>

2.5

R



<CFREGISTRY>

9.4

<CFRETHROW>

5.2

<CFREPORT>

6.7



S



<CFSAVECONTENT>

9.5

<CFSET>

9.7

<CFSCHEDULE>

9.6

<CFSETTING>

11.6

<CFSCRIPT>

10.7

<CFSILENT>

11.7

<CFSEARCH>

6.8

<CFSLIDER>

1.9

<CFSELECT>

1.8

<CFSTOREDPROC>

2.6

<CFSERVLET>

6.9

<CFSWITCH>/<CFCASE>/ <CFDEFAULTCASE>

7.7

<CFSERVLETPARAM>

6.10



Т



<CFTABLE>

4.6

<CFTREE>

1.11

<CFTEXTINPUT>

1.10

<CFTREEITEM>

1.12

<CFTHROW>

5.3

<CFTRY>/<CFCATCH>

5.4

<CFTRANSACTION>

2.7



U


<CFUPDATE>

2.8

W


<CFWDDX>

6.11

 

Категории тегов

Будем использовать следующую классификацию тегов:

1. Теги построения форм.

2. Теги управления базами данных.

3. Теги управления файлами и каталогами.

4. Теги управления выводом.

5. Теги обработки ошибок.

6. Теги расширения функциональности.

7. Теги контроля за процессом исполнения страниц.

8. Теги Internet-протоколов.

9. Теги манипулирования переменными.

10. Теги управления приложениями.

11. Другие теги.

Теги построения форм

Тег

Описание

Код

<CFAPPLET>

Вставляет апплет внутрь тега <CFFORM>

1.1

<CFFORM>

Строит форму ввода

1.2

<CFGRID>

Используется с тегом <CFFORM> для создания процедуры управления табличными данными

1.3

<CFGRIDCOLUMN>

Используется с тегом <CFGRID> внутри тега <CFFORM>, позволяя определить столбцы

1.4

<CFGRIDROW>

Используется с тегом <CFGRID> внутри тега <CFFORM>, позволяя заполнять таблицу данными при отказе от использования запроса в качестве источника данных

1.5

 

Тег

Описание

Код

<CFGRIDUPDATE>

Выполняет обновления таблицы данных

1.6

<CFINPUT>

Используется с тегом <CFFORM> для создания элемента ввода

1.7

<CFSELECT>

Используется с тегом <CFFORM> для создания раскрывающего списка

1.8

<CFSLIDER>

Используется с тегом <CFFORM> для создания движка, перемещаемого по вертикали или горизонтали и позволяющего визуально управлять числовыми величинами в указанном диапазоне

1.9

<CFTEXTINPUT>

Используется с тегом <CFFORM> для создания текстового поля ввода

1.10

<CFTREE>

Используется с тегом <CFFORM> для создания дерева иерархического списка

1.11

<CFTREEITEM>

Используется с тегом <CFTREE> внутри тега <CFFORM>, позволяя определить элементы иерархического списка

1.12

 

Теги управления базами данных

Тег

Описание

Код

<CFINSERT>

Вставляет данные в базу данных

2.1

<CFPROCPARAM>

Задает параметры для хранимых процедур в базе данных

2.2

<CFPROCRESULT>

Описывает набор имен, которые другие теги могут использовать для доступа к результатам работы хранимых процедур

2.3

<CFQUERY>

Передает на выполнение SQL-запрос в базу данных

2.4

<CFQUERYPARAM>

Используется с тегом <CFQUERY>, проверяя тип данных параметра запроса

2.5

<CFSTOREDPROC>

Определяет информацию соединения с базой данных и задает хранимую процедуру, которая должна выполняться

2.6

<CFTRANSACTION>

Группирует запросы в единый пакет транзакции, задавая правила отката в случае ошибок

2.7

<CFUPDATE>

Обновляет информацию в базе данных

2.8

 

Теги управления файлами и каталогами

Тег

Описание

Код

<CFDIRECTORY>

<CFFILE>

Осуществляет управление каталогами

Осуществляет управление файлами

3.1

3.2

 

Теги управления выводом

Тег

Описание

Код

<CFCOL>

Определяет характеристики колонки таблицы, созданной с помощью тега <CFTABLE>

4.1

<CFCONTENT>

Определяет тип содержания и имя файла, который должен быть загружен в браузер

4.2

<CFLOG>

Позволяет записывать сообщения в log-файл

4.3

<CFOUTPUT>

Позволяет выводить значения различных переменных CFML, результатов запросов и других необходимых фрагментов текстов

4.4

<CFPROCESSINGDIRECTIVE>

Удаляет лишние пробелы внутри CFML-конструкций

4.5

<CFTABLE>

Позволяет строить таблицу на стороне ColdFusion

4.6

 

Теги обработки ошибок

Тег

Описание

Код

<CFERROR>

 

 

<CFRETHROW>

 


<CFTHROW>

При возникновении ошибок показывает специально созданные страницы для каждого типа ошибок

Если вам необходимо выполнить некоторые действия при возникновении исключения во внутреннем блоке <CFTRY>, но не прекратить на этом обработку, а передать исключение дальше, внешнему обработчику, вы можете воспользоваться тегом <CFRETHROW>, позволяющим регенерировать исключение

Активизирует обработку исключительной ситуации на странице, которая затем может быть отработана с помощью тега <CFCATCH>

5.1

 

 

5.2

 

 

 

5.3

 

Тег

Описание

Код

<CFTRY>/<CFCATCH>

Позволяет отлаживать и обрабатывать исключительные ситуации во время работы приложения

5.4

 

Теги расширения функциональности

Тег

Описание

Код

<CFCOLLECTION>

Создает и администрирует коллекцию, используется при работе с поисковым сервером Verity

6.1

<CFEXECUTE>

Запускает выполнение любого процесса на

6.2

<CFGRAPH>

сервере

Используется для построения диаграмм, требуется наличия пакета Java-приложений JRun 3.0 Server

6.3

<CFGRAPHDATA>

Используется с тегом <CFGRAPH> для определения данных при построении диаграммы

6.4

<CFINDEX>

Используется для создания индексов коллекции в операциях поиска <CFSEARCH>

6.5

<CFOBJECT>

Вызывает объекты COM, CORBA, Java или EJB

6.6

<CFREPORT>

Запускает предопределенный отчет, созданный в Crystal Reports

6.7

<CFSEARCH>

Выполняет поиск по данным, индексированным в коллекции с помощью тега <CFINDEX>

6.8

<CFSERVLET>

Выполняет Java-сервлет с использованием средств сервера Java-приложений JRun 3.0 Server

6.9

<CFSERVLETPARAM>

Используется с тегом <CFSERVLET> для определения передаваемых параметров

6.10

<CFWDDX>

Упаковывает и распаковывает структуры CFML-данных для WDDX-формата

6.11

 

Теги контроля за процессом исполнения страниц

Тег

Описание

Код

<CFABORT>

Останавливает обработку CFML-страницы в месте расположения тега

7.1

<CFBREAK>

Используется для прерывания работы цикла, организованного конструкцией <CFLOOP>

7.2

<CFEXIT>

Прерывание обработки тега

7.3

<CFIF>/<CFELSEIF>/ <CFELSE>

Условный оператор, обеспечивающий переход к фрагменту кода в зависимости от заданного условия

7.4

<CFLOCATION>

Открывает CFML- или HTML-страницу

7.5

<CFLOOP>

Обеспечивает цикл повторений, основываясь на наборе заданных условий

7.6

<CFSWITCH>/<CFCASE>/ <CFDEFAULTCASE>

Оператор-переключатель, обеспечивающий переключение между различными частями программного кода в зависимости от значения одной переменной или выражения

7.7

 

Теги Internet-протоколов

Тег

Описание

Код

<CFFTP>

Предоставляет возможность работы с файловой системой на стороне определяемого FТР-сервера

8.1

<CFHTTP>

Используется для выполнения методов GET и POST для выгрузки или посылки формы, запроса, cookies или CG l-переменной на заданный сервер

8.2

<CFHTTPPARAM>

Применяется вместе с тегом <CFHTTP> для задания передаваемых параметров при использовании метода POST

8.3

<CFLDAP>

Обеспечивает доступ к серверу LDAP (Lightweight Directory Access Protocol)

8.4

<CFMAIL>

Позволяет отправлять почтовые сообщения

8.5

<CFMAILPARAM>

Используется с тегом <CFMAIL>, позволяет либо присоединять файл, либо добавлять заголовок к сообщению

8.6

 

Тег

Описание

Код

<CFPOP>

Позволяет извлекать сообщения из почтового сервера

8.7

 

Теги манипулирования переменными

Тег

Описание

Код

<CFCOOKIE>

Определяет и устанавливает переменные cookie

9.1

<CFDUMP>

Позволяет наглядно демонстрировать значения простых переменных, запросов,- массивов, структур и WDDX-переменных

9.2

<CFPARAM>

Определяет переменные и их значения по умолчанию

9.3

<CFREGISTRY>

Позволяет считывать, записывать и удалять ключи и их значения в системном реестре операционной системы

9.4

<CFSAVECONTENT>

Сохраняет содержание тега тела страницы <BODY> в определяемую переменную

9.5

<CFSCHEDULE>

Назначает задачу по выполнению конкретных

9.6

<CFSET>

страниц с возможностью генерации статистических документов

Определяет переменные ColdFusion

9.7

 

Теги управления приложениями

Тег

Описание

Код

<CFAPPLICATION>

 

<CFASSOCIATE>

 

<CFAUTHENTICATE>


<CFIMPERSONATE>

Используется для определения основных характеристик приложения

Позволяет данным порожденных тегов храниться вместе с информацией базового тега

Идентифицирует пользователя для предоставления доступа к защищенному содержанию приложения

Позволяет на короткое время предоставить доступ к защищенному содержанию, тем самым, оказать пользователю доверительное отношение

10.1

 

10.2

 

10.3


10.4

Тег

Описание

Код

<CFLOCK>

<CFMODULE> <CFSCRIPT>

Синхронизирует раздел CFML-кода, используя блокировку для обеспечения целостности разделяемых данных

Используется для вызова специального тега

Используется для определения границ кода, написанного на языке CFScript

10.5

10.6 10.7

 

Другие теги

Тег

Описание

Код

<CFCACHE>

Создает временные файлы на основе страниц ColdFusion, которые содержат статические HTML-страницы, позволяя тем самым ускорить отображение страниц

11.1

<CFFLUSH>

Направляет потоки данных клиенту с определенным интервалом по мере их изменения

11.2

<CFHEADER>

Генерирует HTTP-заголовки, которые возвращаются клиенту

11.3

<CFHTMLHEAD>

Пишет текст, указанный атрибутом TEXT, в секцию <HEAD> генерируемой страницы

11.4

<CFINCLUDE>

Включает указанный шаблон в текущую страницу

11.5

<CFSETTING>

Определяет и управляет различными установками в ColdFusion

11.6

<CFSILENT>

Останавливает все выводы, порожденные выполнением CFML-конструкцией внутри области действия тега

11.7